╔══════════════════════════════════════════════════════════════════╗
║                Broschüren-Tool – Einrichtung & Erste Schritte    ║
║                Anleitung für macOS                                ║
╚══════════════════════════════════════════════════════════════════╝

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  WAS IST DAS BROSCHÜREN-TOOL?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Das Broschüren-Tool hilft beim Drucken an den Lexmark XC9455-
Druckern im Haus: PDFs hochladen, Seiten umsortieren/entfernen/
drehen, als A4-Broschüre auf A3-Sammelbogen umbrechen oder mit
mehreren Seiten pro Blatt drucken – inklusive Heften und Lochen,
wo der Drucker das unterstützt.

Es läuft als kleiner Hintergrunddienst auf deinem Mac und öffnet
sich automatisch im Browser. Einmal eingerichtet, startet es bei
jedem Login von selbst.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  VORAUSSETZUNGEN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✅  Mac mit macOS 12 (Monterey) oder neuer
  ✅  Im Schulnetz (WLAN/LAN) – die Drucker sind sonst nicht
      erreichbar
  ✅  Ein beliebiger Browser (Safari, Chrome, Edge, Firefox)
  ✅  Das Broschüren-Tool-Setup-Paket (ZIP-Datei)

  Kein Python, kein Node.js, keine weiteren Programme nötig.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  SCHRITT 1 – SETUP-PAKET ENTPACKEN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  1. Die Datei „Broschueren-Tool Setup.zip" im Finder
     doppelklicken.
     → Ein Ordner „Broschueren-Tool Setup" erscheint daneben.

  2. Den entpackten Ordner öffnen. Du siehst:

       📦 Broschueren-Tool.app          ← das eigentliche Programm
       📄 Zuerst hier klicken.command   ← zuerst starten!

  ⚠️  Wichtig: Beide Dateien müssen im gleichen Ordner bleiben,
      solange die Einrichtung noch nicht gelaufen ist.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  SCHRITT 2 – EINRICHTUNG STARTEN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ──────────────────────────────────────────────────
  ⚠️  WICHTIG: macOS Sicherheitsfreigabe (einmalig)
  ──────────────────────────────────────────────────

  macOS blockiert Programme, die nicht von Apple signiert
  sind – so wie dieses Tool. Die Freigabe erfolgt über die
  Systemeinstellungen und ist einmalig, dauert etwa 1 Minute.

  Anders als beim TeacherOS-Setup muss hier nur EINE Datei
  freigeschaltet werden – der Rest läuft danach automatisch.

  1. RECHTSKLICK auf „Zuerst hier klicken.command"
     (nicht Doppelklick – rechte Maustaste bzw.
      Ctrl+Klick auf dem Trackpad!)

  2. Im Menü „Öffnen" wählen.

  3. macOS zeigt eine Warnung.
     → Erscheint dort direkt ein Knopf „Öffnen"?
       Anklicken – fertig, weiter mit Schritt 8.
     → Erscheint nur „Fertig"? Diesen anklicken und mit
       Schritt 4 fortfahren.

  4. Apfel-Menü oben links → „Systemeinstellungen" öffnen.

  5. „Datenschutz & Sicherheit" anklicken.

  6. Nach unten scrollen bis zum Abschnitt „Sicherheit".
     → Dort steht:
       „Zuerst hier klicken.command wurde blockiert …"
     → Auf „Trotzdem öffnen" klicken.

  7. Mac-Passwort eingeben → „Öffnen" klicken.

  8. Ein Terminal-Fenster öffnet sich. Dort läuft die
     Einrichtung in vier Schritten durch:

       (1/4) App wird aus dem Setup-Ordner kopiert
       (2/4) Kopie wird geprüft
       (3/4) Autostart wird eingerichtet
       (4/4) Virtueller Drucker wird eingerichtet

  ──────────────────────────────────────────────────
  ⚠️  ZWEITE ABFRAGE: Touch ID / Passwort für den Drucker
  ──────────────────────────────────────────────────

  Bei Schritt (4/4) erscheint ein GANZ ANDERER Dialog –
  kein Sicherheitswarnung, sondern die normale macOS-Abfrage
  für „Drucker hinzufügen" (Touch ID oder Passwort). Das ist
  normal und nötig, damit das Broschüren-Tool später direkt
  über Cmd+P in jedem Programm als Drucker auswählbar ist
  (siehe Schritt 3).

  → Touch ID bestätigen bzw. Passwort eingeben und „OK".
  → Wird das übersprungen/abgebrochen, funktioniert das Tool
    trotzdem ganz normal über den Browser – nur der direkte
    Weg über Cmd+P fehlt dann. Kann jederzeit nachgeholt
    werden: „Zuerst hier klicken.command" einfach nochmal
    ausführen.

  9. Am Ende steht im Terminal-Fenster „Fertig! Öffne
     Browser …" und der Browser öffnet sich automatisch mit
     dem Broschüren-Tool.

  10. Das Terminal-Fenster bleibt offen, bis eine beliebige
      Taste gedrückt wird – dann schließt es sich. Kann
      einfach ignoriert/geschlossen werden.

  ✅  Die Einrichtung ist abgeschlossen! Ab jetzt startet das
      Broschüren-Tool bei jedem Login automatisch im
      Hintergrund – „Zuerst hier klicken.command" wird nicht
      mehr gebraucht (außer bei einer neuen Version).


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  SCHRITT 3 – DIREKT AUS JEDEM PROGRAMM DRUCKEN (Cmd+P)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Nach erfolgreicher Einrichtung (inkl. Touch ID/Passwort bei
  Schritt 4/4) steht in JEDEM Programm ein neuer „Drucker"
  namens „Broschueren-Tool" zur Auswahl:

  1. In einem beliebigen Programm (Word, Pages, Safari, …)
     Cmd+P drücken.

  2. Als Drucker „Broschueren-Tool" auswählen → Drucken.

  3. Der Browser öffnet sich automatisch mit dem Dokument
     bereits geladen – dort dann wie gewohnt Layout wählen,
     Seiten bearbeiten und an den gewünschten echten Drucker
     im Haus senden.

  💡 Das Dokument wird bei diesem Schritt NICHT direkt
     gedruckt – es landet nur zur Weiterbearbeitung im Tool.
     Der eigentliche Druck passiert erst danach, ganz normal
     im Broschüren-Tool selbst.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  SCHRITT 4 – TÄGLICHE NUTZUNG
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  1. PDF(s) im Broschüren-Tool ablegen oder direkt über
     Cmd+P → „Broschueren-Tool" hineindrucken (siehe Schritt 3).

  2. Bei Bedarf Seiten umsortieren, entfernen oder drehen
     (per Drag & Drop bzw. den Knöpfen an jeder Seite).
     Klick auf eine Seite zeigt sie groß an.

  3. Layout wählen: normal, 2/4/6/9 Seiten pro Blatt, oder
     Broschüre (A4-Heft auf A3-Sammelbogen).

  4. Bei Bedarf Heften/Lochen einstellen (nur ohne Broschüre-
     Layout sinnvoll, nur an Druckern mit Finisher verfügbar).

  5. Drucker auswählen, Kopienzahl eintragen, „An Drucker
     senden" klicken → Rückfrage bestätigen.

  Alternativ: „PDF herunterladen" erzeugt die fertig
  umgebrochene Datei zum späteren Ausdrucken.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  HÄUFIGE FRAGEN (FAQ)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ❓ Der Browser öffnet sich nicht / „Diese Seite ist nicht
     erreichbar".
  ──────────────────────────────────────────────────────────
  Der Hintergrunddienst läuft möglicherweise nicht (mehr).
  Lösung: „Zuerst hier klicken.command" erneut ausführen –
  das richtet den Autostart neu ein.

  ❓ Kein Drucker im Dropdown erreichbar / „Status nicht
     abrufbar".
  ──────────────────────────────────────────────────────────
  Prüfen, ob der Mac gerade im Schulnetz ist (WLAN/LAN) – die
  Drucker sind von zu Hause aus nicht erreichbar.

  ❓ Warnung „Papier leer" oder „Papier wird knapp" beim
     Drucker.
  ──────────────────────────────────────────────────────────
  Wird automatisch angezeigt, sobald der Drucker das meldet –
  bei DIN A4 (mehrere Fächer) erst, wenn wirklich kein A4-Fach
  mehr bestückt ist. Bei „Heftklammern leer" oder „Locher-
  behälter voll" kurz beim Hausmeister/IT-Team melden.

  ❓ „Broschueren-Tool" taucht bei Cmd+P nicht als Drucker auf.
  ──────────────────────────────────────────────────────────
  Die Touch-ID/Passwort-Abfrage bei Schritt (4/4) wurde
  vermutlich übersprungen. „Zuerst hier klicken.command"
  erneut ausführen und diesmal bestätigen.

  ❓ Eine Kollegin/ein Kollege hat die ZIP per AirDrop erhalten
     – funktioniert die Freigabe genauso?
  ──────────────────────────────────────────────────────────
  Ja, exakt der gleiche Ablauf wie in Schritt 2: Rechtsklick
  auf „Zuerst hier klicken.command" → „Öffnen", bei Bedarf
  zusätzlich über Systemeinstellungen → Datenschutz &
  Sicherheit → „Trotzdem öffnen" freigeben.

  ❓ Ist das Setup-Skript sicher?
  ──────────────────────────────────────────────────────────
  Ja. Es kopiert das Programm nur nach ~/Applications,
  richtet einen automatischen Hintergrunddienst ein und
  registriert einen lokalen virtuellen Drucker (nur auf
  diesem Mac, für Cmd+P). Es verändert keine Systemdateien
  außerhalb der Drucker-Warteschlange und lädt nichts aus
  dem Internet herunter.

  ❓ Wie deinstalliere ich das Broschüren-Tool?
  ──────────────────────────────────────────────────────────
  Im Terminal ausführen:

    launchctl unload ~/Library/LaunchAgents/de.teacheros.broschueren-tool.plist
    rm ~/Library/LaunchAgents/de.teacheros.broschueren-tool.plist
    rm -rf ~/Applications/Broschueren-Tool.app
    lpadmin -x Broschueren-Tool


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Bei Fragen: Roman ansprechen.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
